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Announcements 

The EnterpriseCluster Master Toolkit is a set of templates and scripts 
that allow you to configure ServiceGuard packages for the H P Domain 
I nternet servers as well as for several third-party database management 
systems. This unified set of high availability tools is being released 
together for both H P-UX 10.20 and H P-UX 11.0 in version B.01.01 with 
the following product number: 

• B5139BA license and media 

The master toolkit is a collection of specific product toolkits, which 
i ncl ude the fol I owi ng: 

• HA Foundation Monitor toolkit, designed to monitor the status of an 
entire mission critical environment. 

• H A i nternet tool kits for use with HP Domai n server products. 

• Databasetoolkitsfor Oracle, Informix, Sybase, and Progress database 
management systems. 
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What's in this Version 

Effective with this release, the following product toolkits are available: 

• HA Foundation Monitor. This tool kit is designed to monitor the status 
of the mission critical environment. It assists the HP support 
engineer with tracking cluster availability in the areas of cluster 
nodes, network components, and packages. A cluster availability 
report will be generated nightly if an event occurs in any of these 
areas. 

Refer tothefile readme.pdf, which accompanies the monitor script, 
for detailed information on installing and configuring the HA 
Foundation monitor. 

• HA I nternet Toolkits. These toolkits enable you to run all your 
Domain server software as ServiceGuard packages. Each toolkit 
contains example scripts and package configuration files, together 
with a RE ADM E file that explains how to customize the package for 
your needs. Toolkits are provided for the following Domain 
components: 

— FastTrack Server 

— Enterprise Server 

— Enterprise Server Pro 

— Proxy Server 

— Directory Server 

— Messaging Server 

— Col I abra Server 

— Calendar Server 

Refer totheHP Domain Release Notes on HP-UX 10.20 (J 1582-90112) 
or the H P Domain Release Notes on HP-UX 11.0 (J 1582-90128) for a 
discussion of recent changes to these products, as well as a 
description of problems and workarounds. 

• DatabaseToolkits. These are provided to simplify the setup of 
ServiceGuard packages for your database software. Each toolkit 
contains example scripts and package configuration files, together 
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Table 1-1 


with a RE ADM E file that explains how to customize the package for 
your needs. Toolkits are included for the following database products: 

— Informix 

— Oracle 

— Progress 

— Sybase 


Compatibility Information and Installation 
Requirements 

Compati bility 

The EnterpriseCluster Master Toolkit requires the installation of the 
HP-UX operating system together with either MC/ServiceGuard 
(B3935BA) or ServiceGuard OPS Edition (B5161CA or B5161BA), 
formerly known as M C/Lock Manager. 

Compatible versions of ServiceGuard and H P-UX are shown in the 
following table for the foundation monitor: 

Foundation Monitor Compatibility with ServiceGuard and 
HP-UX 


Toolkit Name 

Toolkit 

Version 

HP-UX Version 

ServiceGuard 

Version 

Foundation 

Monitor 

B.01.47 

10.20 or greater 

A. 10.10 or greater 


Compatible versions of MC/ServiceGuard and ServiceGuard OPS Edition 
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Table 1-3 


are shown in the following table for the database and internet toolkits: 

Database and I nternet Toolkit Compatibility with 
MC/ServiceGuard and ServiceGuard OPS Edition 


Master Toolkit 

HP-UX Version 

MC/ServiceGuard 

ServiceGuard 

OPS Edition 

B.01.01 

HP-UX 10.20 

A. 10.10 or greater 

A. 10.07.01 or 
greater 

B.01.01 

HP-UX 11.0 

A. 11.01 or greater 

A. 11.01 or greater 


Compatible versions of database and I nternet scripts are shown in the 
following table: 

Script Compatibility with Internet Servers and Databases 


Internet Server or 
Database Name 

Internet Server or 

Database Version (as 
shown in swlist output) 

Toolkit Version 
(“what” string) 

FastTrack Server 

B.03.01.05 

B.01.02 

Enterprise Server 

B.03.06.00 

B.01.02 

Enterprise Server Pro 

B.03.05.04 

B.01.02 

Proxy Server 

B.03.05.04 

B.01.02 

Directory Server 

B.03.01.03 

B.01.02 

Messaging Server 

B.03.05.04 

B.01.02 

Collabra Server 

B.03.05.01 

B.01.02 

Calendar Server 

B.03.05.02 

B.01.02 

Informix 

All 

A.10.11 

Oracle 

7.3.x, 8.0.x 

B.01.00 

Sybase 

10.0.2 

A. 10.11 

Progress 

7.3.A 

A.10.11 
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Installation 

Use the H P-UX swinstaii command to install the Enterprise Cluster 
Master Toolkit on the cluster node where you plan to perform package 
configuration tasks. The locations of the specific tool kits aregiven in the 
next sections. 

Location of Foundation Monitor Toolkit 

The foundation monitor toolkit isfound in the following directory: 

Directory Pathnames of Toolkits 


Toolkit 

Directory Pathname 

HA Foundation Monitor 

/opt/cmcluster/toolkit/foundation 


Follow the instructions in the readme.pdf filethat accompanies the 
toolkit. 

Locations of Internet Toolkits 

The I nternet toolkits are found in the following directories: 

Directory Pathnames of I nternet Toolkits 


Internet Toolkit 

Directory Pathname 

FastTrack Server 

/opt/cmcluster/toolkit/fasttrack 

Enterprise Server 

/opt/cmcluster/toolkit/domain 

Enterprise Server Pro 

/opt/cmcluster/toolkit/domain 

Proxy Server 

/opt/cmcluster/toolkit/domain 

Directory Server 

/opt/cmcluster/toolkit/domain 

Messaging Server 

/opt/cmcluster/toolkit/domain 

Collabra Server 

/opt/cmcluster/toolkit/domain 

Calendar Server 

/opt/cmcluster/toolkit/domain 


Follow the instructions in the READM E filethat accompanies thetoolkit 
you wish to configure as a package. 
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Locations of Database Tool kits 

The database tool kits are found in the following directories: 

Directory Pathnames of Database Toolkits 


Database Toolkit 

Directory Pathname 

Informix 

/ opt/ cmcluster/t oolk.it/ informix 

Oracle 

/opt/cmcluster/toolkit/oracle 

Sybase 

/opt/cmcluster/toolkit/Sybase 

Progress 

/opt/cmcluster/toolkit/progress 


Follow the instructions in the READM E filethat accompanies thetoolkit 
you wish to configure as a package. 


What Manuals are Available for this Version 

For information about configuring packages using the toolkits, refer to 
the following manuals. I n addition, be sure to review the README file 
that accompanies thetoolkit you are using. 

• Managing MC/ ServiceGuard (B3936-90026) 

• Configuring OPS Clusters with ServiceGuard OPS Edition 
(B 5158-90026) 

I f you are a Domai n user, you should refer to the FI P Domai n Release 
Notes on FI P-UX 10.20 (J 1582-90112) or the FI P Domain Release Notes on 
HP-UX 11.0 (J 1582-90128) for a discussion of recent changes tothese 
products as well as a discussion of problems and workarounds. 
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Patches and Fixes in this Version 

There are no patches or fixes in this version. 


Known Problems and Workarounds 

The following describes known problems with the Enterprise Cluster 
Master Toolkit and workarounds for them. 

I f you are a Domai n user, you should refer to the H P Domai n Release 
Notes on HP-UX 10.20 (J 1582-90112) or the H P Domain Release Notes on 
HP-UX 11.0 (J 1582-90128) for a discussion of additional problems and 
workarounds. 

Naming of Netscape Server Instances 

• What is the problem? If you configure multiple instances of the same 
N etscape server type, and the Serverl D of one server is a substri ng of 
the Serverl D of another server, ServiceGuard may fail the wrong 
package unexpectedly. 

• What is the workaround? Choose distinct, non-overlapping instance 
names as in the foil owing example: 

ServerlDl: httpd-defaultl 

ServerID2: httpd-default2 


Do not use httpd-default for ServerlDl and httpd-defaultl for 
ServerID2. 


Changed Directory Location and Port Setting for 
Enterprise Server (Version 3.6) 

• What is the problem? I n Netscape Enterprise Server (version 3.6), the 
installation directory and port setting have been modified. 

• What is the workaround? I n the runhalt script enterprises!! (version 
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B.01.02) Iine51, modify the environment variable SE RVER as 
follows, to reflect the new installation directory: 

SERVER=/opt/ns-enterprise3 6/https-${SERVER_ID} 


When accessing the administration server for Enterprise Server 
version 3.6, use port 17493. For example in your browser, use the 
following URL: 

http://192.1.1.3:17493 

where 192.1.1.3 is the IP address of the system on which you are 
running the administration server. 

Failure of the uxwdog Monitoring Process 

• What is the problem? In Enterprise Server version 3.6, a Unix 
daemon, uxwdog, now monitors the health of the web server daemon, 
known as https-< InstanceName>, where InstanceName is the name 
you give to a specific server instance. (The default daemon name is 

https-default.) 

I f the web server process termi nates, the uxwdog daemon wi 11 
automatical ly restart the web server daemon. The problem is that 
when the uxwdog daemon terminates with the web server still 
running, the administration server cannot be used to stop or start the 
Webserver. (This problem can be caused by using the command kill -9 
<PI D>, where <PI D> is the process id of the uxwdog daemon.) 

F urthermore, the tool kit that is monitoring the uxwdog daemon will 
cause the package to fail over to the adoptive node, and it will fail to 
run on the adoptive node. 

• What is the workaround? If the uxwdog daemon fails, the web server 
process should be manually killed as in the following: 

kill -9 <PID> 

where <pid> is the process id of the web server process. This will 
allow the web server to be started through the control of the 
administration server. 
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Software Availability in Native Languages 

The Enterprise Cluster Master Toolkit is not available in native 
language versions. 
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